@mchades Could you help me review this pull request?

Overall LGTM.

I tried to merge user_permissions.yaml and group_permissions.yaml. But it throws an error.

Can you describe the steps to reproduce it? Or provide detailed error information?

Overall LGTM.

I tried to merge user_permissions.yaml and group_permissions.yaml. But it throws an error.

Can you describe the steps to reproduce it? Or provide detailed error information?

Put them into one file.

[1] ../docs/open-api/user_permissions.yaml:118:5 at #/paths/1metalakes1{metalake}1permissions1users~1{user}1revoke/1metalakes1{metalake}1permissions1groups1{group}~1grant

Property /metalakes/{metalake}/permissions/groups/{group}/grant is not expected here.

116 | $ref: "./openapi.yaml#/components/responses/ServerErrorResponse"
117 |
118 | /metalakes/{metalake}/permissions/groups/{group}/grant:
| ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
119 | parameters:
120 | - $ref: "./openapi.yaml#/components/parameters/metalake"

referenced from ../docs/open-api/openapi.yaml:138:5 at #/paths/1metalakes1{metalake}1permissions1users~1{user}~1revoke

Error was generated by the spec rule.

[2] ../docs/open-api/user_permissions.yaml:165:5 at #/paths/1metalakes1{metalake}1permissions1users~1{user}1revoke/1metalakes1{metalake}1permissions1groups1{group}~1revoke

Property /metalakes/{metalake}/permissions/groups/{group}/revoke is not expected here.

163 | $ref: "./openapi.yaml#/components/responses/ServerErrorResponse"
164 |
165 | /metalakes/{metalake}/permissions/groups/{group}/revoke:
| ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
166 | parameters:
167 | - $ref: "./openapi.yaml#/components/parameters/metalake"

referenced from ../docs/open-api/openapi.yaml:138:5 at #/paths/1metalakes1{metalake}1permissions1users~1{user}~1revoke

Error was generated by the spec rule.

[3] ../docs/open-api/openapi.yaml:141:5 at #/paths/1metalakes1{metalake}1permissions1groups~1{group}~1grant

Can't resolve $ref: ENOENT: no such file or directory '/Users/roryqi/Code/gravitino/docs/open-api/users_permissions.yaml'

139 |
140 | /metalakes/{metalake}/permissions/groups/{group}/grant:
141 | $ref: "./users_permissions.yaml#/paths/1metalakes1%7Bmetalake%7D1permissions1groups1%7Bgroup%7D1grant"
| ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
142 |
143 | /metalakes/{metalake}/permissions/groups/{group}/revoke:

Error was generated by the no-unresolved-refs rule.

[4] ../docs/open-api/openapi.yaml:144:5 at #/paths/1metalakes1{metalake}1permissions1groups~1{group}~1revoke

Can't resolve $ref: ENOENT: no such file or directory '/Users/roryqi/Code/gravitino/docs/open-api/users_permissions.yaml'

142 |
143 | /metalakes/{metalake}/permissions/groups/{group}/revoke:
144 | $ref: "./users_permissions.yaml#/paths/1metalakes1%7Bmetalake%7D1permissions1groups1%7Bgroup%7D1revoke"
| ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
145 |
146 | components:

Error was generated by the no-unresolved-refs rule.

Indentation issue